home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 3 / Light ROM 3 - Disc 2.iso / programs / pc / dem2_3ds / 3 / dem23ds.doc next >
Text File  |  1995-04-18  |  7KB  |  147 lines
  1.                      *** DEM to 3DS file converter ***
  2.                      by Stephane Vilette  (04-18-1995)
  3.  
  4.  
  5. 1.0 Introduction
  6. ----------------
  7.   Often I've seen people complaining about the fact that they had to use
  8. DXF export/import to use VistaPro's DEM files in 3D Studio because it
  9. takes a lot of time to export big DEM.
  10.   So I did it : a DEM to 3DS converter. It can export very large DEM files
  11. in just a few seconds.
  12. This converter is totaly Freeware. You can use it and distribute it as
  13. you like. But if you enjoyed it and found it usefull, leave me a mail
  14. so that I'll know if it's worth making improvements.
  15.  
  16.  
  17. 1.1 Limitations
  18. ---------------
  19.     * In VistaPro, you must save DEM file using the "Save DEM Session"
  20.       If you just use "Save DEM", some informations will miss in the DEM
  21.       file such as Light position, Camera Position and Color Maps.
  22.     * The DEM file must be saved with a Polygon Size of 1. If you use
  23.       another size, you will probably get strange results.
  24.     * Color Maps can not be exported. This will be added in a next release.
  25.       (in fact, I don't know if it's really possible. It seems that the only
  26.       way to recreate a VistaPro-like texture in 3DS would be to use a IPAS
  27.       SXP)
  28.  
  29.  
  30. 2.0 Syntaxe
  31. -----------
  32. Here is the syntaxe you must use :
  33.    
  34.  DEM23DS -iDEMFile[.DEM] [-o3DSFile[.3DS]] [-mPAthFile[.MPS]]
  35.          [-L] [-C] [-Sn] [-Q]
  36.  
  37.   Switches description
  38.   --------------------
  39.     -i   This switch must be followed by the name of the DEM file to be
  40.          converted. This switch is optional if a MPS file is specified.
  41.          The DEM extension is optional. If not specified, it will be added 
  42.          at the end of the filename.
  43.  
  44.     -o   This switch must be followed by the name of the output 3DS file.
  45.          This switch is optional. If not specified, the name of the 3DS
  46.          file will be the name of the specified DEM file (switch -i) or 
  47.          the name of the DEM file included in the MPS file with .3DS 
  48.          extension. The .3DS extension is optional. If not specified, the 
  49.          .3DS extension will be added at the end of the filename.
  50.     
  51.     -m   This switch must be followed by the name of the MPS file created
  52.          with MakePath (Save Session). This switch is optional if a DEM file 
  53.          is specified. The .MPS extension is optional. If not specified, it 
  54.          will be added at the end of the filename. 
  55.          The MPS file contains the DEM filename with which is has been 
  56.          created. If no DEM file is specified, the programm will search 
  57.          the DEM filename in the MPS file.
  58.     
  59.     -L   This switch tells the converter not to export the Light position.
  60.          If not specified, the light position will be exported. If you
  61.          have specified a MPS file in the command line, this switch will
  62.          be ignored and the light will be exported.
  63.  
  64.     -C   This switch tells the converter not to export the Camera. If not
  65.          specified, the camera position, target, bank and fov will be
  66.          exported. If you have specified a MPS file in the command line, 
  67.          this switch will be ignored and the camera will be exported.
  68.  
  69.     -Sn  This switch determines the quality of the output Landscape in the
  70.          3DS file. The 'n' value can be any number between 1 and 8.
  71.          1 is the best quality and 8 the worst.
  72.          I've created this switch because the exportation of DEM files can
  73.          create VERY big 3DS files (a normal DEM file (258x258) creates a
  74.          landscape of 132098 faces. The maximal size a DEM files can be is
  75.          2050x2050. That would produce a 8405000 faces landscape).
  76.          Here is how the 'n' value works : The converter reads 1 point
  77.          every 'n' points on the DEM file. That is if you specifie -S3,
  78.          a 258x258 DEM file will produce a 86x86 vertices (258/3) landscape.
  79.          Even for a final rendering, a quality of 2 is often enough.
  80.          If you want a fast preview (for example to place objects on the
  81.          scene and have a faster rendering), you can use a n value of 4 or 5.
  82.          Values of 6 to 8 gives really bad results but they can be useful 
  83.          for really large DEM files.
  84.  
  85.     -Pn  This switch specifies the number of keys that will be exported from
  86.          the MPS file. In a MPS file, a camera position is specified for
  87.          every frames in the animation. With this switch, you can tell the
  88.          converter to read only every 'n' key in the MPS file. As 3D Studio
  89.          can interpolate the camera position between 2 keys, using this
  90.          switch, you can create smaller 3DS files. The smallest value for
  91.          'n' is 1. The highest is the number of frames in the animation.
  92.  
  93.     -Q   Quiet mode. When this switch is specified, the converter doesn't
  94.          display all the information messages during the conversion.
  95.  
  96.  
  97. 3.0 History
  98. -----------
  99. 09/19/94 : v0.41ß. First public release on Compuserve and a few BBS of a beta
  100.            version. Developped with Borland Pascal 7.01. Many linitations
  101.            because of the 64K limit for array sizes.
  102.  
  103. 01/23/94 : v1.00. Because of a hard disk failure, all my sources were lost.
  104.            This version was entierely rewritten with Watcom C++ 10.0a.
  105.            As it is the first time I'm programming in C, it took me a lot
  106.            of time to release this version.
  107.            This version can export infinite DEM sizes and you can choose
  108.            the quality of the output file.
  109.  
  110. 04/18/95 : v1.20. First public release with camera path exportation.
  111.  
  112.  
  113. 4.0 Things to do
  114. ----------------
  115. * Export textures. I'm not sure if I'll do it because DEM files just contain
  116.   the color of faces, not the fractal texture. So the best way to keep a nice
  117.   texture, would be to use an IPAS SXP (I don't think that such an IPAS
  118.   exists, that's why I've ordered the IPAS developpement kit to create one).
  119. * Any other suggestion I might receive...
  120.  
  121.  
  122. 5.0 How to contact the author
  123. -----------------------------
  124. If you have problems or suggestion about this converter, you can contact
  125. me on Compuserve of by E-Mail :
  126.  
  127. Stephane Vilette
  128. E-Mail       : vilette@ibm.net
  129.                or stephane.vilette@atd.fdn.fr
  130. Compuserve   : 100332,3073
  131. BBS (FRANCE) : CAD Connection (33)+1-39.52.98.54 (Sysop : Nenad Boric)
  132.     Graphisme.Fr conference.
  133.     PCGNet 3D Studio conferences.
  134.     UseNet Graphics conferences.
  135.  
  136.  
  137. 6.0 Thanks
  138. ----------
  139. I'd like to thank John Hinkley who made a great job releasing VistaPro and
  140. who gave me many help about the DEM file format and for his improvement
  141. suggestions. (Note: It's no use asking me about the DEM file format. This
  142. format is not released in public domain. If you want more informations about
  143. this format, ask John Hinkley. You can join him on Compuserve in the VRLI 
  144. forum).
  145. And I'd also like to thank Rational System Inc. because their DUMP3DS 
  146. utility saved me a lot of time to figure out the 3DS file format.
  147.